宣言ファイルとは？

宣言ファイル（.d.tsファイル）は、TypeScriptで既存のJavaScriptライブラリを使用するための基本的なパーツです。

昔のことはよくわからないですが、typescript2.0以降は基本的にはnpmだけでいい感じにできます。

宣言ファイルが存在しないライブラリの場合

参考

宣言ファイルの特徴

https://blogs.msdn.microsoft.com/typescript/2016/06/15/the-future-of-declaration-files/

宣言ファイルの書き方

https://blogs.msdn.microsoft.com/typescript/2016/12/14/writing-dts-files-for-types/

---

環境宣言 Ambient Declarations

環境宣言は既存のjavascriptのライブラリをtypescriptのプロジェクトで安全にいい感じで使うためのものです。 もともとtypescriptはそこ(既存のjavascriptとの互換性)を考えて作られているので実際にどうやってやるのか見ていきましょう・

Declaration file

declare 宣言を使ってどこか他の場所に本当の(生js)のコードがあることをtypescriptの教えてあげることができます

環境宣言はドキュメントみたいなもん

ソースを変更時にはこちらも一緒に変更する必要があります。

参考

https://basarat.gitbooks.io/typescript/docs/types/ambient/d.ts.html